Enterprise Gateway Installation and Configuration
Perform the following steps to install and configure the Enterprise Gateway.
To Configure and Install the Enterprise Gateway
Note: If you are installing the Enterprise Gateway on a system where no other CygNet components are installed and you are not using the default domain, you must set the Enterprise Gateway ambient domain. Do so using the CygNet Domain Connection Utility (CygConn.exe).
Important: The CygNet v9.8 Enterprise Gateway requires the installation of Microsoft .NET Framework, in accordance with the CygNet system requirements. See the
CygNet v9.8 System Requirements for more information.
- Run CygNetEnterpriseGatewaySetup.exe.
- Edit the file GatewaySettings.xml.
Copy
GatewaySettings.xml
<?xml version="1.0" encoding="utf-8" ?>
<serviceConfig>
<inboxPath>C:\Program Files\EnterpriseGateway\inbox</inboxPath>
<outboxPath>C:\Program Files\EnterpriseGateway\outbox</outboxPath>
<requestTTL>600000</requestTTL>
<logfileTTL>7</logfileTTL>
<enableVerboseLogging>false</enableVerboseLogging>
<validateRequests>true</validateRequests>
<validateResponses>false</validateResponses>
<authorizedUsers>
<user>domain\authorizeduser1</user>
<user>domain\authorizeduser2</user>
<user>domain\authorizeduser3</user>
<user>domain\authorizeduser4</user>
<user>domain\authorizeduser5</user>
<user>domain\authorizeduser6</user>
<user>domain\authorizeduser7</user>
<user>domain\authorizeduser8</user>
<user>domain\authorizeduser9</user>
<user>domain\authorizeduser10</user>
</authorizedUsers>
<administrativeUsers>
<user>domain\authorizeduser1</user>
</administrativeUsers>
<packageLocation />
<xsdLocation />
<diagInfo>
<ARSAddress>127.0.0.1</ARSAddress>
</diagInfo>
</serviceConfig>- For the inboxPath and outboxPath, enter the names of the Input Requests and Output Responses directories as specified in the Enterprise Operations device. These must not be the same.
- For the requestTTL, enter the length of time (in milliseconds) for the Enterprise Gateway to wait for a response from the Enterprise Operations EIE. If not specified, the default is 600000 (milliseconds).
- For the logfileTTL, enter the length of time (in days) for the Gateway to keep log files. If not specified, the default is 7 (days).
- Set enableVerboseLogging to
[true]if you want to see the entire request/response cycle on a given request, and to[false]if you do not. Default is [false]. - Set validateRequests to
[true]if you desire Requests validation (recommended) against the Native and Business Objects schemas - Set validateResponses to true if you desire Responses validation (recommended) against the Native and Business Objects schemas, and to false if you do not.
- Specify the authorizedUsers of the Enterprise Gateway. Usernames are case insensitive. You must use the fully qualified network ID (domain\user ID).
Note: Only 10 users are allowed. The IDs of the first 10 users are active; if you specify more than 10, the additional users will be ignored.
- Specify the administrativeUsers of the Enterprise Gateway. Usernames are case insensitive. You must use the fully qualified network ID (domain\user ID). Gateway Administrators listed here will have access to administrative functions such as refreshPackage for Business Objects.
- For the packageLocation, enter the file path and file name for the current package. This must be set for the Enterprise Gateway to attempt to load a package file.
- For the xsdLocation, enter the file path and file name for the generated xsd files to be kept . If the packageLocation is set and the xsdLocation is not set, the default xsdLocation used will be
[EnterpriseGatewayDir/\XSD]. - For diagnostic information, specify the ARSAddress to which the Enterprise Gateway connects.
- Edit the CygNetEnterpriseGateway.exe.config.
- For the add node, set the value of the baseAddress attribute to that of the IP address of the machine on which the Enterprise Gateway is running. This address defines the address to which the Enterprise Gateway is listening for requests.
- If the Enterprise Gateway is installed on a machine that is running IIS, you must also specify a port in the address that is not in use by any process on the machine. The format is IPAddress:Port (for example, 192.168.2.32:8000).
Copy
CygNetEnterpriseGateway.exe.config
<?xml version="1.0"?>
<configuration>
<configSections>
</configSections>
<system.serviceModel>
<services>
<service name="CygNet.EnterpriseGatewayService.EnterpriseGatewayService" behaviorConfiguration="EnterpriseGatewayServiceBehavior">
<host>
<baseAddresses>
<add baseAddress="https://184.168.2.20:8000/"/>
</baseAddresses>
</host>
<!-- -->
<!-- this endpoint is exposed at the base address provided by host -->
<!-- -->
<endpoint address="" binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_EnterpriseGateway" contract="CygNet.EnterpriseGatewayService.EnterpriseGateway"/>
<endpoint address="" binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_EnterpriseGateway" contract="CygNet.EnterpriseGatewayService.EnterpriseGatewayDiagnostics"/>
<!-- -->
<!-- this endpoint is exposed at the address <base address>/EnterpriseGateway -->
<!-- -->
<endpoint address="EnterpriseGateway" binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_EnterpriseGateway" contract="CygNet.EnterpriseGatewayService.EnterpriseGateway"/>
<endpoint address="EnterpriseGateway" binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_EnterpriseGateway" contract="CygNet.EnterpriseGatewayService.EnterpriseGatewayDiagnostics"/>
<!-- -->
<!-- this endpoint is exposed at the address <base address>/EnterpriseGatewayBasic -->
<!-- -->
<endpoint address="EnterpriseGatewayBasic" binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_EnterpriseGateway" contract="CygNet.EnterpriseGatewayService.EnterpriseGateway"/>
<endpoint address="EnterpriseGatewayBasic" binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_EnterpriseGateway" contract="CygNet.EnterpriseGatewayService.EnterpriseGatewayDiagnostics"/>
<!-- -->
<!-- the mex endpoint is exposed at -->
<!-- -->
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="EnterpriseGatewayServiceBehavior">
<serviceMetadata httpGetEnabled="True"/>
<serviceDebug includeExceptionDetailInFaults="True"/>
</behavior>
</serviceBehaviors>
</behaviors>
<bindings>
<wsHttpBinding>
<binding name="WSHttpBinding_EnterpriseGateway" closeTimeout="00:20:00" openTimeout="00:20:00" receiveTimeout="00:20:00" sendTimeout="00:20:00" bypassProxyOnLocal="false" transactionFlow="false" hostNameComparisonMode="StrongWildcard" maxBufferPoolSize="10000000" maxReceivedMessageSize="10000000" messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true" allowCookies="false">
<readerQuotas maxDepth="32" maxStringContentLength="10000000" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384"/>
</binding>
</wsHttpBinding>
<basicHttpBinding>
<binding name="BasicHttpBinding_EnterpriseGateway" closeTimeout="00:20:00" openTimeout="00:20:00" sendTimeout="00:20:00" receiveTimeout="00:20:00" hostNameComparisonMode="StrongWildcard" bypassProxyOnLocal="false" maxBufferPoolSize="10000000" maxReceivedMessageSize="10000000" messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true" allowCookies="false">
<security mode="TransportCredentialOnly">
<transport clientCredentialType="Windows"/>
</security>
</binding>
</basicHttpBinding>
</bindings>
</system.serviceModel>
</configuration>
